For operating systems where no binary is provided or if
you want the latest development version, you will have to build it from
source. The code should be compilable on any system with
-ISO C89 compilers. It's been tested on UnixWare, OpenServer, OS/X,
-Linux, Solaris, and a variety of processors and compilers.
+ISO C89 compilers, though we use a smattering of C99 like double slash
+comments. It's tested on Linux, Mac OS/X, and Windows cross compilers.
+Less frequently, someone will build on MSVC, FreeBSD, OpenBSD, Solaris,
+UnixWare, OpenServer, etc. It's also exercised on a variety of
+processors and compilers.
</para>
<para>
-You can grab a release from the <ulink url="http://www.gpsbabel.org/download.html">GPSBabel download page</ulink>, but if you're going to be doing any development, you'll find that working from the <ulink url="http://sourceforge.net/cvs/?group_id=58972">GPSBabel CVS tree</ulink> is easier.
+You can grab a release from the <ulink url="http://www.gpsbabel.org/download.html">GPSBabel download page</ulink>, but if you're going to be doing any development, you'll find that working from the <ulink url="http://code.google.com/p/gpsbabel/source/checkout">GPSBabel SVN tree</ulink> is easier.
</para>
- <para>
+<para>
+For most cases, an anonymous checkout of the trunk is really all you need.
+That can be done easily with the single command:
+</para>
+<para><userinput>
+ svn checkout http://gpsbabel.googlecode.com/svn/trunk/gpsbabel
+</userinput></para>
+
+<para>
In most cases, the code is as simple to build as running:
</para>
<para><userinput> ./configure && make</userinput></para>
<para> This command will read from a Magellan unit attached
to the first serial port on a Linux system (device names will
vary on other OSes; typically COMx: on WIndows) and write them as a geocaching loc file.</para>
-<example>
+<example id="linux_download_from_magellan">
<title>Command showing Linux download from Magellan serial and writing to .loc file</title>
<para><userinput>gpsbabel -i magellan -f /dev/ttyS0 -o geo -F mag.loc</userinput></para>
</example>
<para>This second command does the same on Microsoft Windows.</para>
-<example>
+<example id="windows_download_from_magellan">
<title>Command showing Windows download from Magellan serial and writing to .loc file</title>
<para><userinput>gpsbabel -i magellan -f com1 -o geo -F mag.loc</userinput></para>
</example>
<parameter moreinfo="none">-i</parameter> argument is seen.
Files are read in the order they appear. So you could merge
three input files into one output file with: </para>
- <example>
+ <example id="merging_files">
<title>Merging multiple files into one</title>
<para><userinput>gpsbabel -i geo -f 1.loc -f 2.loc -f 3.loc -o geo -F big.loc</userinput></para>
</example>
<para>You can merge files of different types:</para>
- <example>
+ <example id="merging_different_types_of_files">
<title>Merging multiple files of differing types.</title>
<para><userinput>gpsbabel -i geo -f 1.loc -i gpx -f 2.gpx -i pcx 3.pcx -o gpsutil -F big.gps</userinput></para>
</example>
- <example>
+ <example id="multiple_writes">
<title>Writing the same data in multiple output formats.</title>
<para> You can write the same data in different output formats:</para>
output. Additional formats may be added by interested parties
later.
</para>
-<example>
+<example id="realtime_reading">
<title>Read realtime positioning from Garmin USB, write to Keyhole Markup</title>
<para><userinput>gpsbabel -T -i garmin -f usb: -o kml -F xxx.kml</userinput></para>
<para>
</para>
</example>
-<example>
+<example id="realtime_reading_wintec">
<title>Read realtime positioning from Wintec WBT-201 via Bluetooth on Mac, write to Keyhole Markup</title>
<para><userinput>gpsbabel -T -i nmea -f /dev/cu.G-Rays2-SPPslave-1 -o kml -F xxx.kml</userinput></para>
<para>
For something-separated data that has headers identifying the various
fields, see our <link linkend="fmt_unicsv">universal csv</link> format.
</para>
-<example><title>Example 'csv' file</title>
+<example id="csv_example"><title>Example 'csv' file</title>
<programlisting>
35.97203, -87.13470, Mountain Bike Heaven by susy1313
36.09068, -86.67955, The Troll by a182pilot & Family
</para>
<para>
- <table>
+ <table id="structure">
<title>Track point structure (16 bytes)</title>
<tgroup cols="3">
<thead>
projects / gpsbabel.git / commitdiff